Release 10.1A: OpenEdge Development:
Java Open Clients

Objects required to access SmartDataObjects

The Open Client Runtime provides three Java classes that you need to access a remote SmartDataObject from a Java application. These and other supporting classes are provided in the com.progress.open4gl package:

SDOResultSet — This is an extended subset of the JDBC 2 ResultSet interface, which provides access to a SmartDataObject. Because all instances of a SmartDataObject present the same 4GL API, the one SDOResultSet class allows you to access any such instance.

SDOResultSet allows you to access only the default SmartDataObject API generated by the OpenEdge AppBuilder. If you need to access custom programmer extensions to this API, you must access the SmartDataObject API directly. For more information, see OpenEdge Development: Open Client Introduction and Programming .

AppObject or SubAppObject — These objects allow you to create an SDOResultSet (using _createSDOResultSet()) to access any remote SmartDataObject. You can access the SDOResultSet object from these proxy objects:
Any standard AppObject or SubAppObject you generate in ProxyGen.
A prebuilt com.progress.open4gl.SDOAppObject proxy that is installed as part of Open Client Runtime.

Using a standard AppObject or SubAppObject allows you to map other AppServer procedures besides SmartDataObjects into the generated proxy. The SDOAppObject installed with OpenEdge is a complete proxy that allows you to access any SmartDataObject without having to build a proxy in ProxyGen. Essentially, it is a complete AppObject built to access only SDOResultSet objects.

Thus, if you need to access only SmartDataObjects on the AppServer and no other AppServer procedures, you can use this SDOAppObject as is. If you need to access other 4GL procedures on the AppServer in addition to the SmartDataObject, you also can use any AppObject or SubAppObject generated with ProxyGen to access any SmartDataObject.

SDOParameters — This is an object you can pass to the SDOResultSet constructor through the _createSDOResultSet() method. SDOParameters allows you to modify the default behavior of the SDOResultSet instance.